home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software 2000
/
Software 2000 Volume 1 (Disc 1 of 2).iso
/
utilities
/
u223.dms
/
u223.adf
/
HAMedit10.doc
< prev
next >
Wrap
Text File
|
1987-06-06
|
10KB
|
157 lines
_____________________________________________________________________
\
HamEdit10 |
Written by James Carpino of Resolution Computer Research (RCR). |
I am placing this program in the public domain. |
This program may be copied in its |
entirety and distributed, and may not |
be used or sold for commercial use. |
Resolution Computer Research is currently a small non-profit |
software development company devoted to the development of |
software and hardware for the Commodore 64/128 and Amiga PCs. |
WE ARE NOT RICH so if you find any RCR programs useful |
please feel free to send a donation of $2 or more to: |
---------------------------------\ |
James Carpino | |
Resolution Computer Research | |
86-08 106th street Richmond Hill | |
New York, NY 11418 | |
---------------------------------/ |
We are also currently working on: |
HAM (Hold-And-Modify) Image Editor: This is this program. Enjoy it. |
We're always improving it and updating it. |
HAM library for C language, to use HAM in your own software. |
Theese routines are used in HAM Image Editor. |
Emily-64: a 6502 microprocessor emulator to enable the Amiga |
to eventually run Apple II, Commodore 64, and Atari 800XE |
software. This will hopefully run at full speed, but we NEED |
a developer's kit or Manx C compiler/assembler donation TO |
accomplish this. |
Dimension-Three: AmigaBasic program to plot three-dimensional |
formulas on any resolution screen (including interlaced). |
EditWave: AmigaBasic program to edit 256-byte waveforms with |
sine, square, triangle, etc. waveforms and mixing. |
_____________________________________________________________________/
\
Any donations will be recorded with the donor's name |
and put towards our development needs. If, at any point, |
we succeed in developing products worthy of sale for a profit, |
any donations will be returned at the rate of twice the donated |
value. Until we are on our feet (business-wise) we can make |
no promises as to the return of donated funds, equipment, etc. |
_____________________________________________________________________/
\
The Instructions: *
How to use HamEdit10:
Call the program from AmigaDos, using the following paramaters:
HamEdit10 -h[height] -w[width] -i
Leaving out the -h and -w paramaters will cause HamEdit10 to default to
the 320*200 screen format. Any height over 232 will be made interlaced.
Using the -h option with no parameter will cause height to default to 400.
Some examples:
HamEdit10 -h233 ;Creates a HAM screen 320 by 233 interlaced.
HamEdit10 -w352 -h ;Creates a HAM screen 352 by 400 interlaced.
HamEdit10 -h100 -w100 -i ;Creates a HAM screen 100 by 100 interlaced.
HamEdit10 -h230 ;Creates a HAM screen 320 by 230 non-interlaced.
HamEdit10 -w336 -h156 -i ;Creates a HAM screen 336 by 156 interlaced.
HamEdit10 -i ;Creates a HAM screen 320 by 200 interlaced.
It is important to remember that the Amiga hardware can do low-resolution
screens up to 368 dots in width, and high-resolution screens up to 736 in
width. Under Kickstart 1.1, though, these screens will not work properly
unless perfectly centered by Preferences (the screen position slider), and
screens over 352 (704 hires) will not work at all, regardless of the slider.
Under Kickstart 1.2, the screen will work properly regardless of the
position of the Preferences screen slider, though you may not see all of
it. As for height, non-interlaced screens may go up to 236 in height and
interlaced screens may go up to 472 in height. Again, if the screen is not
positioned correctly, it may not work properly under Kickstart 1.1. If the
screen is above 200 or 400 interlaced, 1.1 will not show that part which
streches over the limit. The only way to remedy this in 1.1 is to go to the
top of the screen, and drag the screen drag bar upwards until all the screen
is visible. The screen will not move, but the bottom border will, and the
mouse pointer will point to a position several dots lower. In Kickstart
1.2, the entire screen will automatically be visible (provided the
Preferences screen position gadget is in the upper left corner), but the
pointer will not reach below the 200 (or 400 interlaced) limit.
"Wait a minute- did he say ALL? Uh- I can't see all of it, my 368 by
472 screen goes off the screen no matter what I do!" says a fairly well-
educated experimenter, who is sure he has the preferences slider all the
way to the upper left. He has a problem: His monitor will not physically
display a screen much larger than 320 (or 640 hi-res) by 200 (or 400
interlaced). This is true of all the current Commodore monitors and most
color monitors. They do something called overscanning. This is so the
scanning gun in the CRT (Cathode Ray Tube) has time to get from the right of
the screen to the left of the screen, and from the top to the bottom. It is
different on most monitors (TV's, composite, RGB, etc.) so the Amiga uses
the position gadget in Preferences to make sure most of the screen is
visible. If you have a monochrome monitor, or an old-fashioned color TV
with all the controls, you can change the Horizontal and Vertical size;
usually the smallest settings will allow for most of a 368 by 472 screen to
be displayed. Some expensive RGB monitors will display the larger screens,
too; and if you have an expensive high-persistence phosphor monitor which
displays the full 368 by 472 screen, you're rich and you should have bought
a XEROX mainframe with a few graphics terminals.
Now, back to our little graphics editor. The commands are summarized as
follows:
d --Goes to draw mode (full lines), just like in DeluxePaint.
s --Goes into spots mode (dotted lines), just like DeluxePaint.
, (comma key) --Picks a color from anywhere on the screen, not including
the palette; this is similar to DeluxePaint, but the color is chosen
immediately. This can be held down to roll through colors on screen.
. (period key) --Changes the brush size to 3*3, similar to DeluxePaint.
- (minus key) Reduces the X and Y size of the brush. (DeluxePaint)
= (Equals key, look at the plus sign) Increases the width of the brush.
\ (Backslash key, next to the = key) Increases the height of the brush.
HELP --Redraws all the information and fixes brush size, color, and
drawing mode to default; also pops back menu bar and windows to
original positions.
F10 --Pops in and out the MENU bar, to allow for the full screen height.
[ and ] --Change the current color to one of the 16 colors; these are
fast and are not HAM colors. (These keys also work in DeluxePaint)
8-9,5-6,2-3: Up and down for HAM red, green, and blue, respectively.
The current HAM color is also displayed as standard color #8. (These
keys also work in DeluxePaint)
Del --(above the BackSpace key) Clears the screen and does HELP.
ESC --The beloved escape key- Exits the program, relieving you of the
terrible wrath of drawdom.
The Color and Info windows can be moved anywhere you like, but currently
they cannot be popped away.
If you click or move either of the Color or Info windows, the first click
you make in the drawing screen will not draw; this is so you do not goof up
a picture just for the sake of selecting the correct window. The Info&Color
windows will tell you in the title bar when they are selected to remind you
of this.
The Info window has the pen position in its title bar, and within the
window are listed the pen width and height, color, and red, green, and blue
elements of the current pen color.
Clicking within the color window chooses any of the colors displayed
within the color window, including the bottom 16 colors. Color #8 will
always turn to the current color, so there's no purpose to using #8.
The current color number will also appear in the info window. The size of
the color window depends on the size of the screen; when the screen size
is shorter than 300, not all the colors will be displayed.
Remember to fix Preferences to 80 columns, HamEdit10 currently does not
open its own font; this saves memory and time.
If your screen will be larger than normal, remember to move the screen
slider in Preferences to the upper left.
The penwidth can be no less than 3 dots wide because it takes 3 dots to
makea HAM color: 1 for red, 1 for green, and 1 for blue. If you have to
increase the size of the brush drastically, increase the height; height is
drawn faster than width. You can, however, draw with a brush 1 dot wide if
you are using one of the bottom 16 colors.
If there is anything I've forgotten, you'll notice it before long.
HamEdit still does not save, load, undo, and all those lovely features that
normal painting programs have. HamEdit is still being worked on, and all
those features will be added in the future. First priority are load/save
and shading, before anything else; one of these two features will appear in
HamEdit11. If you find any bugs or awkwardnesses (besides the awkward word
awkwardnesses) please tell me about them. We sometimes forget to fix even
the bugs we know about.
Sincerely,
James Carpino, Programmer
Resolution Computer Research